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Basic Types & Variables 


bool - Boolean 


Unsigned integers 
u8, u16, u32, u64, u128 


Signed integers 
i8, 116, i32, i64, 1128 


Floating point numbers 
32, f64 


Platform specific integers 
usize - Unsigned integer. Same number of bits as the 
platform's pointer type. 


isize - Signed integer. Same number of bits as the 
platform's pointer type. 


char - Unicode scalar value 
&str - String slice 
String - Owned string 


Tuple 


let coordinates = (82, 64); 
let score = ("Team A", 12) 


Array & Slice 


// Arrays must have a known Length and all 
elements must be initialized 

let arrays= il, 255 35) 4, Sis 

let array2 = [@; 3]; // [@ @, 4] 


// Unlike arrays the Length of a slice is 
determined at runtime 
let slice = &array[1 .. 3]; 


HashMap 


use std::collections: :HashMap; 


let mut subs = HashMap: :new(); 
subs.insert(String::from("LGR"), 1000@@) ; 
// Insert key if it doesn't have a value 
subs.entry("Golang Dojo".to_owned()) 
.or_insert(3); 


Struct 


// Definition 

struct User { 
username: String, 
active: bool, 


} 


// Instantiation 

let user1 = User { 
username: String::from("bogdan"), 
active: true, 


}3 


// Tuple struct 
struct Color(i32, i32, i132); 
let black = Color(@, 9, @); 


Enum 


// Definition 
enum Command { 


Quit, 

Move { x: 132, y: 132 }, 
Speak(String), 
ChangeBGColor(i32, i32, 132), 


// Instantiation 

let msg1 = Command: : Quit; 

let msg2 = Command: :Move{ x: 1, y: 2 };3 

let msg3 = Command: :Speak("Hi".to_owned()); 
let msg4 = Command: :ChangeBGColor(@, @, @); 


Constant 


const MAX_POINTS: u32 = 100 000; 


Static variable 


// Unlike constants static variables are 
// stored in a dedicated memory Location 
// and can be mutated. 

static MAJOR_VERSION: u32 


= le 
static mut COUNTER: u32 = Q; 


Mutability Returning from loops 


let mut x = 5; let mut counter = Q; 
xX = 6; 
let result = loop { 


Shadowing counter += 1; 


let x = 5; 
et exe=— Xess 2: 


if counter == 10 { 
break counter; 


i 
Type alias pe 
// NanoSecond is a new name for ~u64°. 
type NanoSecond = u6é4; while and while let 
while n < 101 { 
Control Flow n t= 1; 
} 
if and if let 
let num = Some(22); let mut optional = Some(@); 
if num.is_some() { while let Some(i) = optional { 
println! ("number is: {}", num.unwrap()); ayerMRel (Caf yp ale 
ii } 


// match pattern and assign variable 
if let Some(i) = num { ; 
printin! ("number is: {}", i); for n in 1..101 { 

} Digamitedlia (Gea beuemin) is 

} 


for loop 


loop let names = vec!["Bogdan", "Wallace"]; 


let mut count = @; 


loop { for name in names.iter() { 
count += 1; printlin! ("{}", name); 
if count == 5 { } 


break; // Exit Loop 


} match 


} 
let optional = Some(@); 


Nested loops & labels match optional { 


‘outer: loop { Some(i)r => pranklnliCG tas.) i), 
"inner: loop { None => println! ("No value.") 
// This breaks the inner Loop } 
break; 


// This breaks the outer Loop 
break ‘outer; 
} 
i} 


References, Ownership, and Ownership and functions 


Borrowing cA Ce 
let x = 5; 
Ownership rules takes _copy(x); // x is copied by value 
1. Each value in Rust has a variable that’s called its 
owner. let s = String::from("Let’s Get Rusty!"); 
2. There can only be one owner at a time. // s is moved into the function 
3. When the owner goes out of scope, the value will takes_ownership(s); 
be dropped. 
// return value is moved into s1 
Borrowing rules let si = gives _ownership(); 
1. At any given time, you can have either one 
mutable reference or any number of immutable let s2 = String::from("LGR"); 
references. let s3 = takes_and_gives_back(s2); 
2. References must always be valid. } 
Creating references fn takes_copy(some_integer: i32) { 


let s1 = String::from("hello world!"); println!("{}", some_integer) ; 


let s1_ref = &s1; // immutable reference } 


fn takes_ownership(some_string: String) { 
printlin!("{}", some_string); 

} // some_string goes out of scope and drop 

is called. The backing memory is freed. 


let mut s2 = String::from("hello"); 
let s2 ref = &mut s2; // mutable reference 


s2_ref.push_str(" world!"); 


fn gives _ownership() -> String { 


Copy, Move, and Clone let some_string = String::from("LGR") ; 


// Simple values which implement the Copy some_string 

trait are copied by value } 

let x = 5; 

let y = x; fn takes_and_gives_back(some_string: 
String) -> String { 

princlnliGt Ose / x Use seu imvalad some_string 
} 


// The string is moved to s2 and si is 
tnvalidated 

let s1 = String::from("Let's Get Rusty!"); 
let s2 = s1; // Shallow copy a.k.a move 


pRinclin (Gems) ae) sero = Sill SaeUnVGlaud 


let si 
let s2 


String: :from("Let's Get Rusty!"); 
si.clone(); // Deep copy 


// Valid because si isn't moved 
princln! (the) si) 


Pattern Matching 


Basics 
let x = 5; 
match x { 


// matching Literals 

1 => printlin! ("one"), 

// matching multiple patterns 

2 | 3 => printinl(’two or three”), 
// matching ranges 

4..=9 => printlin! ("within range"), 
// matching named variables 

x > alee is SO). 

// default case (ignores value) 

_ => printin! ("default Case") 


Destructuring 


struct Point { 
Xe 


lene fo) = (Poplins sf 39 Gs WS We 


match p { 
Point { x, y: @ } => { 
print lm ae)s 
}s 
Point 4 x,y ) => 4 
Prantl (th yy ep Cay jG 
js 
} 


enum Shape { 
Rectangle { width: i132, height: 1i32 }, 
Circle(i32), 

} 


let shape = Shape::Circle(1@); 


match shape { 
Shape: :Rectangle { x, y } => //... 
Shape: :Circle(radius) => //... 

} 


Ignoring values 


struct SemVer(i32, i32, i132); 


let version = SemVer(1, 32, 2); 


match version { 


} 


SemVer(major, _, _) => { 
println! ("{}", major); 
iy 


let numbers = (2, 4, 8, 16, 32); 


match numbers { 


} 


GRUPSIE, oon Jessie) Sh af 
Dip nieln Gee ent! RSicemel ast) 
} 


Match guards 


let num = Some(4); 


match num { 


Some(x) if x < 5 => println!("less than 


al City hues XO) iy 


} 


Some(x) => printlin!("{}", x), 
None => (), 


@ bindings 


struct User { 


atfol® aley2 


let user = User { id: 5 }; 


match user { 


User { 
id: id_variable @ 3..=7, 
} => println!("id: {}", id_variable), 
User {raids Ore =125 e555 f 
printin! ("within range"); 
}; 
User { id } => println!("id: {}", id), 


lterators 
Usage 


// Methods that consume iterators 
let v1 = vec![1, 2, 3]; 

let vi_iter = v1.iter(); 

let total: i132 = vi1_iter.sum(); 


// Methods that produce new iterators 
Het va Vecc32> ==) vec! [Mey 25asir 
let iter = v1.iter().map(|x| x + 1); 


// Turning iterators into a collection 
let v1: Vec<i32> = vec![1, 2, 3]; 

let v2: Vec<_> = vil.iter().map(|x| x + 
1) eecollect(); 


Implementing the Iterator trait 


struct Counter { 
count: u32, 


} 


impl Counter { 
fn new() -> Counter { 
Counter { count: @ } 
} 
} 


impl Iterator for Counter { 
type Item = u32; 


fn next(&mut self) -> Option<Self::Item> 
{ 
if self.count < 5 { 
self.count += 1; 
Some(self.count) 
} else { 
None 


Error Handling 


Throw unrecoverable error 


panic! ("Critical error! Exiting!"); 


Option enum 
fn get_user_id(name: &str) -> Option<u32> { 


if database.user_exists(name) { 
return Some(database.get_id(name) ) 


None 


Result enum 


fn get_user(id: u32) -> Result<User, Error> 
it 
if is logged_in_as(id) { 
return Ok(get_user_object(id)) 
i 


Err(Error { msg: "not logged in" }) 
} 


? operator 


fn get_salary(db: Database, id: i32) -> 
Option<u32> { 

Some(db.get_user(id)?.get_job()?.salary) 
} 


fn connect(db: Database) -> 
Result<Connection, Error> { 
let conn = 
db.get_active _instance()?.connect()?; 
Ok(conn) 
} 


Combinators Boxing errors 
-map use std::error; 
let some_string = Some("LGR".to_owned()); 


type Result<T> = std::result: :Result<T, 


: Box<dyn error: :Error>>; 
let some_len = some_string.map(|s| 


s.len()); 
Iterating over errors 
struct Error { msg: String } 


Ignore failed items with filter_map() 
struct User { name: String } 


Nene Gelinas Se Wevell | Mel yz 7) |B 


let b g Wee< SS Sul 
let string result: Result<String, Error> = a ress ca = Pee 
Ok("Bogdan".t d ; : cs 
eet LOE NEE): .filter_map(|s| s.parse::<i32>().ok()) 
.collect(); 
let user_result: Result<User, Error> = 0; 
string result.map(|name| { 
User { name } Fail the entire operation with collect() 
})5 letestrings: — vec! SUGRS 2265) 7 a3 
-and_then let numbers: Result<Vec<_>, _> = strings 
Sali@hetoy alte 
let vec = Some(vec![1, 2, 3]); oe ae eee 
let first_element = vec.and_then( ee i te 


.collect(); 
|vec| vec.into_iter().next() 03 


Z Collect all valid values and failures with partition() 
let string result: Result<&'static str, _> 
= Ok("5"); 
let number_result = 

string result 

.and_then(|s| s.parse::<u32>()); 


lietstringss—— Vee! [SUGRey 7 22e ere ls 


let (numbers, errors): (Vec<_>, Vec<_>) = 
strings 
.into_iter() 
.map(|s| s.parse::<i32>()) 
Multiple error types .partition(Result::is_ok); 
blanca EU let numbers: Vec<_> = numbers 
.into_iter() 
.map(Result: :unwrap) 
.collect(); 


type Result<T> = std::result::Result<T, 
CustomError> ; 


#[derive(Debug, Clone) ] 


struct CustomError ; let errors: Vec<_> = errors 


.into_iter() 
.map(Result::unwrap_err) 
.collect(); 


impl fmt::Display for CustomError { 
fn fmt(&self, f: &mut fmt::Formatter) -> 
fmt: :Result { 
write!(#, "custom error message") 
} 
i 


Generics, Traits, and Lifetimes 


Using generics 


struct Point<T, U> { 
Xian 
y: U, 

} 


impl<T, U> Point<T, U> { 
fn mixup<V, W>(self, other: Point<V, W>) 
-> Point<T, W> { 


Point { 
x: self.x, 
yo sother.y., 
ii 


} 
i 


Defining traits 
trait Animal { 

fn new(name: &'static str) -> Self; 

fn noise(&self) -> &'static str { "" } 
} 


struct Dog { name: &'static str } 


impl Dog { 
fn -fetch(): 4 77... } 
} 


impl Animal for Dog { 
fn new(name: &'static str) -> Dog { 
Dog { name: name } 


} 


fn noise(&self) -> &'static str { 
"woof!" 


Default implementations with Derive 


// A tuple struct that can be printed 
#[derive(Debug) ] 
struct Inches(i32); 


Trait bounds 


fn largest<T: PartialOrd + Copy>(list: 
AU ee 10 al 
let mut largest = list[@]; 


for &item in list { 
if item > largest { 
largest = item; 
i 
i 


largest 
} 


impl trait 
fn make_adder_function(y: i132) -> impl 
Fn(i32) -> i32 { 
let closure = move |x: i32| { x + y }; 
closure 


Trait objects 


pub struct Screen { 
pub components: Vec<Box<dyn Draw>>, 


} 


Operator overloading 


use std::ops: :Add; 


#[derive(Debug, Copy, Clone, PartialEq) ] 
struct Point { 


impl Add for Point { 
type Output = Point; 


fn add(self, other: Point) -> Point { 
Point { 
x: self.x + other.x, 
y: self.y + other.y, 
ii 
Ir 
} 


Supertraits 


use std::fmt; 


trait Log: fmt::Display { 
fn log(&self) { 
let output = self.to_string(); 
println! ("Logging: {}", output); 
oi 
i 


Lifetimes in function signatures 
fn longest<'a>(x: &'a str, y: &'a str) -> 
&'a str { 
if x.len() > y.len() { 
X 
} else { 


y 
} 
i 


Lifetimes in struct definitions 


struct User<'a> { 
full_name: &'a str, 


} 


Static lifetimes 


let s: &'static str = "Let’s Get Rusty!"; 


Functions, Function Pointers & 
Closures 


Associated functions and methods 


struct Point { x: i132, y: 132, } 


impl Point { 
// Associated function 
fn new(x: i132, y: i132) -> Point { 
PYoulme sf 63 Ney WE WY I 
ii 


// Method 
fn getX(&self) -> i132 { self.x } 


Function pointers 


fn do_twice(f: fn(i32) -> 132, arg: i32) -> 
rey af 

f(arg) + f(arg) 
} 


Creating closures 


let add_one = |num: u32| -> u32 { 
num + 1 


je 


Returning closures 


fn add_one() -> imp] Fn(i32) -> i32 { 
Ix] x +1 


fn add_or_subtract(x: i32) -> Box<dyn 
Fni(a32)) => 132> 
if x > 10 { 
Box: :new(move |y| y + x) 
} else { 
Box::new(move l|y| y - x) 
I 
} 


Closure traits 
e FnOnce - consumes the variables it captures 
from its enclosing scope. 
e FnMut - mutably borrows values from its 
enclosing scope. 
e Fn - immutably borrows values from its enclosing 
scope. 


Store closure in struct 


struct Cacher<T> 
where 

T: Fn(u32) -> u32, 
aL 

calculation: T, 

value: Option<u32>, 


} 


Function that accepts closure or function pointer 


fn do_twice<T>(f: T, x: i132) -> i132 
where T: Fn(i32) -> 132 


{ 
F(x) + F(x) 
i 


Pointers 


References 


let mut num = 5; 
let r1 = &num; // immutable reference 
let r2 = &mut num; // mutable reference 


Raw pointers 


let mut num = 5; 

// immutable raw pointer 

let ri = &num as *const i32; 
// mutable raw pointer 

let r2 = &mut num as *mut i132; 


Smart pointers 
Box<T> - for allocating values on the heap 


let b = Box: :new(5); 


Re<T> - multiple ownership with reference counting 


let a = Rc::new(5); 
let b Rc: :clone(&a) ; 


Ref<T>, RefMut<T>, and RefCell<T> - enforce 
borrowing rules at runtime instead of compile time. 


let num = 5; 

let ri = RefCell::new(5); 

// Ref - immutable borrow 

let r2 = r1.borrow(); 

// RefMut - mutable borrow 

let r3 = r1.borrow_mut(); 

// RefMut - second mutable borrow 
let r4 = r1.borrow_mut(); 


Multiple owners of mutable data 


let x = Rc::new(RefCell: :new(5)); 


Packages, Crates, and Modules 


Definitions 
e Packages - A Cargo feature that lets you build, 


test, and share crates. 

e Crates - A tree of modules that produces a 
library or executable. 

e Modules and use - Let you control the 
organization, scope, and privacy of paths. 

e Paths - A way of naming an item, such as a 
struct, function, or module. 


Creating a new package with a binary crate 


$ cargo new my-project 


Creating a new package with a library crate 


$ cargo new my-project --lib 


Defining and using modules 


fn some_function() {} 


mod outer_module { // private module 
pub mod inner_module { // public module 

pub fn inner_public_function() { 

super: :Super::some_function(); 


} 


fn inner_private_function() {} 


i 
} 


fn main() { 
// absolute path 
crate: :outer_module:: 
inner_module::inner_public_function(); 


// relative path path 
outer_module:: 
inner_module::inner_public_function(); 


// bringing path into scope 
use outer_module::inner_module; 
inner_module::inner_public_function(); 


Renaming with as keyword Defining modules in separate files 


use std::fmt::Result; Vf SRG/LIED ERS 
use std::io::Result as IoResult; mod my_module; 
Re-exporting with pub use pub fn some_function() { 


my_module: :my_function(); 
mod outer_module { 


pub mod inner_module { 
pub fn inner_public_function() {} 


} 


// src/my_moduLle.rs 
pub fn my_function() {} 


pub use crate: :outer_module: :inner_module; 


